Shareware Super Platinum 8

home *** CD-ROM | disk | FTP | other *** search

/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / ACE20B.ZIP;1 / MACRO.DOC < prev next >

Wrap

Text File | 1994-07-27 | 94.3 KB | 3,925 lines

‹‹‹‹‹ ‹‹‹‹‹ ﬁ€€€€€€€€› ‹‹‹‹‹ ﬁ€€€€€€€€› ﬁ€€€€ ﬁ€€€€ﬁ€€€€€€€€› ‹‹‹‹‹‹‹ﬁ€€€€ €€€€ ‹‹‹‹‹ ﬁ€€€› ﬁ€€€ﬁ€€€€ €€€€ﬁ€€€€€€€ﬁ€€€› €€€€€€€› ﬁ€€€€€€€€€€ﬁ€€€› €€€€ ﬁ€€€€ €€€ €€€ ‹‹‹‹‹‹ ‹‹‹‹‹ ﬁ€€€› ﬁ€€€ﬁ€€€€€ €€€€€€€ﬁ€€€€€ €€€ €€€ﬁ€€€€€€€€€ ﬁ€€€€€€€€€ €€€€ ﬁ€€€€ﬁ€€€› €€€ﬁ€€€ ﬁ€€€› €€€ﬁ€€› €€€ﬁ€€€ €€€ ﬁ€›€€€ €€€ ﬁ€› €€€› ﬁ€€€› €€€€€€€€€ﬁ€€€€€€› €€€€€€€€ €€€€€€€€ ﬁ€€ ﬁ€€ €€€ﬁ€€›ﬁ€€ ﬁ€€ ﬂﬂ ﬂﬂﬂ ﬂﬂﬂﬂﬂ ﬂﬂﬂﬂﬂﬂ ﬂﬂﬂﬂﬂ ﬂﬂﬂﬂ ﬂﬂ ﬂﬂ ﬂﬂ ﬂﬂﬂ AceComm (tm) Macro Language Copyright 1991-1994 by MGP Software, all rights reserved. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without express written permission from MGP Software. The software described in this publication is furnished under a license agreement and may be used or copied only in accordance with the terms of that agreement. This publication and its associated software are sold without warranties, either expressed or implied, regarding their merchantability or fitness for any particular application or purpose. The information in this publication is subject to change without notice and does not represent a commitment on the part of MGP Software. In no event shall MGP Software be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential, or other damages resulting from the use of or the inability to use this product, even if MGP Software has been notified of the possibility of such damages. First Printing, July 1994 AceComm version 1.90 All brand and product names mentioned in this publication are trademarks or registered trademarks of their respective holders. AceComm Software Support You can get more help by contacting the author Michael Phelps at the following - VOICE 602-846-4563 6 days 12-7pm MST - BBS 602-846-2940 24 hours - COMPUSERVE User ID 75120,3306 - FIDONET ADDRESS 1:114/35 - FIDONET COMM echo - FIDONET ACECOMM echo I distribute the "ACECOMM" echo to USA NODES, until it makes BACKBONE. - Write to: MGP Software (AceComm) *New Address* BOX 301 C Route 3 Yes we are moving Detroit Lakes, MN 56501 USA later this year. T a b l e o f C o n t e n t s Chapter 1 AceComm Macro Language..............................1 Chapter 2 Macros list.........................................3 Local User Input (LUI) Functions.................4 Character I/O Functions..........................9 Flags...........................................20 File Functions..................................21 Data Transfer functions.........................24 Dialing/Fon.Record..............................27 Misc Functions..................................30 Chapter 3 MACRO Parameter Symbols............................33 PRM-data Representatives........................34 Replaceable Macro Functions.....................40 Chapter 4 Scripts............................................41 AutoScriptGen (Tm)..............................42 Labels, Gotos, Data Area........................47 Mini Host Script Example........................49 Chapter 5 LICENSE............................................56 Chapter 6 Contacting the author..............................59 Chapter 1 AceComm Macro Language Almost all of AceComm's internal functions are represented with a macro programming language. The AceComm keyboard is completely re-programmable using the macro language. In fact, the AceComm keyboard is macro driven. Many of AceComm's menus are also macro driven, and can be re-programmed. Some of the menus are user definable, where the title and menu items can be defined by the user. Reference to characters such as carriage return, space, escape, etc. are made in this document. Reference to a character is made in the following manner. <CR> <SP> where <CR> refers to a carriage return, and <SP> refers to a space character. Macros are bounded by the same <> brackets as character reference. Character references are not macros. A complete macro listing follows this chapter. What is a Macro? ---------------- o Macros are directives bounded inside of angle brackets < > o Macros must have a SPACE character in front of the '<' left bracket when stacking. <ChgDir>[DIR_MAIL] <RunProg>OFFLINE <ChgDir>[DIR_START] | | |_________________| | Leading space o Macros may be any combination of CaSe <RunProg> jmodem <runprog> jmodem o The Macro Processor supports "Macro Stacking". Macro Stacking means multiple Macros per line <SendStr>u z ACE0601.ARJ^M <SendZmo>files\ace0601.arj <SendStr>u z ACE0601.ARJ^M <RunProg>DSZ sz -m files\ace0601.arj <SetDTR> ON <SendStr>ATDT846-2940^M <WaitStr>CONNECT <SendStr>^[^[ o MACRO DATA PARAMETERS are bounded inside of square brackets [ ] o MACRO DATA PARAMETERS need not have a <SP> character in front of them o MACRO DATA PARAMETERS must be upper CASE <SendStr>[USER_NAME]^MY^M[FON_PWD] | | | | | Data Param (Fon.Record password field) | | Page 1 AceComm (tm) v 1.90 | ^M translates into a <CR> (carriage return) | Data Param (IEMSI user name field) <SendStr>[USER_NAME]^M~[PASSWORD]^M | | | | | | | | | IEMSI password field | | | | | | | One second delay (~ = second delay) MACRO | | | Control character representation for <CR> | MACRO DATA PARAMETER (IEMSI data) o MACRO FUNCTION PARAMETERS are prefixed with a % character <SendZmo> %PF | | | MACRO FUNCTION PARAMETER (prompt for filename) | Internal Zmodem sending unit <RunProg>dsz port %P speed %B sz %PF %WK <SendStr>^M | | | | | | | | | | | MACRO FUNCTION PARAM | | | (wait for key press) | | | | | MACRO FUNCTION PARAM | | (prompt for filename) | | | MACRO FUNCTION PARAM | (insert ascii baud) | MACRO FUNCTION PARAM (insert ascii port) Please submit all macro suggestions to: a) MSG to Michael Phelps on the AceComm Support BBS b) MSG to Michael Phelps on Compuserve UID 75120,3306 Page 2 Chapter 1 AceComm Macro Language Chapter 2 Macros list Page 3 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Local User Input (LUI) Functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ LUI MACROS require local user input, and so are not suited to un-attended scripts. LUI MACROS contain a '_' underscore as the last character inside the brackets. <AutoAMenu_> Bring up a quick "Point Mail" / "Auto Answer" service menu. This for those using the scheduler and automated host modes. <AutoScrGen_> Toggle AutoScrGen(tm) mode Toggle AutoScript Generation mode On/Off. When "On" an extended status line will appear at the bottom of the TERMINAL screen. At the far left of the extended status line will be the phrase "AutoScriptGen" <ScrollBack_> Menu Area Enter Back Buffer Screen Area The "Scroll Back Buffer" contains the last n lines of display that scrolled off the TERMINAL screen. <ScrollBack_> has a status line of it's own. The status line contains such information as current line position into the buffer, total lines buffered, and some of the navigational keys are displayed. <CaptureFile_> Toggle Capture File Prompts for filename Capture will also prompt for append or overwrite. Capture does absolutely NO filtering of any kind. All data is recorded to file "as it comes in the port". The AceComm package comes with separate utilities which can strip video control codes from files. See also <OpenCapture> filename <CloseCapture> <DOSShell_> Enter Shell to Command Processor/ Operating System In most cases "Drop to DOS", if your DOS compatible operating system places it's name in the environment where AceComm can find it. "Shell" is not hard wired to COMMAND.COM but the COMMAND PROCESSOR as found in the environmental data area. Page 4 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Local User Input (LUI) Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Notes: When SWAP is "ON", the serial port is effectively disabled during the shell. When SWAP is "OFF" the serial port remains active and any incoming data is handled properly, unless the receive buffer wraps around. <FileReq_> Menu driven EMSI file request function. <PhoneList_> Menu Area Enter .FON List / Dialer Dial/.FON directory area. While AceComm allows manual dialing from inside the TERMINAL area, it most convenient to dial from a record contained in one of the .FON files available for use from the DIAL area. <FileList_> Menu Area Enter File Lister Files lister inside AceComm provides a basic directory list function capable of changing directories and drives. File-marking, deletion, selection for appropriate file-utility, etc. LISTFILES may be created. UPLDS.LST is a file created by the Tag feature inside the File Lister Area. files tagged will be listed inside UPLDS.LST as CR LF terminated strings. When selecting any of AceComm's internal batch capable sending protocols, AceComm will check for the existent of the file UPLDS.LST and allow sending from the LISTFILE if desired. <MdmHangUp_> Prompts Yes/no before, Sends PRM-data MDM_HANGUP string to modem. Waits 1/2 second, then drops DTR for 1 second. See also <MdmHangUp> (no Yes/no prompt, good in scripts) <PrmData_> Menu Area Enter PRM-data Menu Area (Configuration Area) Notes: When AutoSave is "ON", all data changed is automatically saved when exiting the PRM-data area. <RProtocols_> Menu Area Page 5 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Local User Input (LUI) Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Enter Receiver Protocols Area menu <RunScript_> List .SCR directory, Allow selection, Run selected .SCR file Lists the PRM-data .SCR directory Allows selection of a .SCR file for immediate execution. Notes: AceComm allows .SCR file as an argument when started which immediately executes the script. <ScrnDump_> Menu Area Take Screen Snapshot Create a "SnapShot" of the current screen minus any status lines active. Prompts for a filename. Filenames always will have the .SNA extension. AceComm can detect and will strip away filename extensions provided by the user when they do not match that of the function. This command is available from most ALT POP UP REFERENCE areas. <ScrnTag_> Menu Area Enter Screen Tagger Screen Area Tagger will allow tagging to the first SPACE_CHAR or press RIGHT-ARROW Tagger tags the entire line of text. Tagger has it's own status line, and a block cursor will appear inside of the Tagger mode. Tagged items will be assigned to the next available SHIFT-Fn key. Tagger pops up the SHIFT-Fn key window and displays each tagged item, as they are tagged. Tagger is most handy for grabbing filenames for download off a BBS screen. SHIFT-Fn key fires the tagged item back when ready. This command is available from most ALT POP UP REFERENCE areas. <SProtocols_> Menu Area Enter Sender Protocols Area <KeyRef_> Bring up Pop up Reference The key press assigned this macro is always displayed on the right side of the status line. <TopBar> Page 6 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Local User Input (LUI) Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Activate the menu bar at top of screen The key press assigned this macro is always displayed on the right side of the status line. "Top Bar" menu can also be brought up inside the terminal area by double clicking the left mouse button. The following macros can be used to call individual menus otherwise choices from the TopBar single line menu <FileMenu> The TopBar File menu <HelpMenu> The TopBar Help menu The key press assigned this macro is always displayed on the right side of the status line. <Users> The TopBar Users menu This is a menu that lists and allows menu selection for the User menus. (User1 - User5) <PhoneMenu> Calls the <FonListDialer_> macro <SetupMenu> Calls the <PrmDataMenus_> macro <XfrMenu> The TopBar Transfer menu <User>n The following individual User menus can be brought up by themselves. Otherwise they are selectable from inside the <Users> menu. The macro takes a parameter 1 - 5 <User>1 This macro brings up User menu # 1. ... Page 7 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Local User Input (LUI) Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <User>5 This macro brings up User menu # 5. Page 8 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø ≥ Many macros are3 way toggles. Where no parameter toggles. ≥ ≥ ≥ ≥ <AutoAnswer>ON ; Enable ≥ ≥ <AutoAnswer>OFF ; Disable ≥ ≥ <AutoAnswer> ; Toggle ≥ ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ -------------------- I/O Function Toggles -------------------- <AutoAnswer> <AutoAnswer>ON ; Enable <AutoAnswer>OFF ; Disable <AutoAnswer> ; Toggle PRM-data MDM_HOST_INIT is sent to the modem when hostmode flag is toggle "ON". PRM-data MDM_INIT is sent to the modem when hostmode flag is toggled "OFF". AceComm begins responding to the RI bit SET, and will send the MDM_ANSWER string to the modem when RI BIT becomes asserted. Upon Answer/Connect, AceComm attempts to match the modem response to strings defined in the Auto Answer Setup menu. The appropriate macro stack will then be run. AceComm stores the actual connect speed for use with the %C macro parameter. %B represents the port rate, %C represents the connect speed as reported by the modem. If you are using <AutoAnswer> alone, without any host script or host software, then be sure and also use <HostEcho>ON. If you want to act as a host with characters being bounced back to the caller. Notes: Auto Answer is also terminated whenever the user dials out from the FON LIST MENU AREA. If automated auto answer is being used by way of the scheduler, then auto answer mode will be re-entered as soon as AceComm detects carrier drop. See also Auto Answer Setup menu <DoorWayMode> <DoorWayMode>ON ; Enable <DoorWayMode>OFF ; Disable <DoorWayMode> ; Toggle Toggle doorway mode. Traps the key press on entry, whatever key press you assign <DoorWayMode> to, is the only way back out. Doorway sends all key presses to the modem in their RAW 'un-cooked' form. Non extended key presses are send LOW BYTE ONLY. Extended key presses are sent LOW BYTE, HIGH BYTE. Notes: Pressing CONTROL BREAK will always end AceComm. CONTROL BREAK is a Page 9 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ back door to the <EndAceComm> macro. When you exit the program by pressing CONTROL BREAK, all data is saved as usual, and program cleanup is as it would be using the <EndAceComm> macro. <HostEcho> <HostEcho>ON ; Enable <HostEcho>OFF ; Disable <HostEcho> ; Toggle Toggle Host echo mode. This macro emulates HostMode's ECHO capability. It does not answer the phone. Use <AutoAnswer>On to have AceComm answer. Host echo means that characters typed locally will be displayed both local and sent to the modem. Host echo will also translate <CR> into <CR><LF> pairs and <BS> into <BS><SP><BS>. <LocalEcho> <LocalEcho>ON ; Enable <LocalEcho>OFF ; Disable <LocalEcho> ; Toggle Toggle local character echo. Local key-presses will be echoed to the screen. (same effect as sending "ATE1^M" to the modem) If you use <LocalEcho> be sure your modem is set up with echo off. To turn the modem echo off ATE0 ------------------------------------- I/O Flags Toggles internal to AceComm ------------------------------------- <BitStrip> <BitStrip> on <BitStrip> off <BitStrip> AceComm going to strip high bit from ascii characters (above 127d) <CTS> <CTS> on <CTS> off <CTS> AceComm uses CTS/RTS hardware handshaking. <XON> Page 10 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <XON> on <XON> off <XON> AceComm uses XON/XOFF software handshaking ---------- I/O Modem ---------- <GetDCD> Returns 0 or 1 current carrier detect signal :DIAL ... <GetDCD> <if>1 <goto>CONNECT <goto>DIAL ... :CONNECT <MdmHangUp> Sends PRM-data MDM_HANGUP string to modem. Waits 1/2 second, then drops DTR for 1 second. <MdmStill> <MdmStill>n Wait for n seconds where nothing arrives from the modem. <SendStr>d^M ACE185.ZIP^M <RecvZmo> <MdmStill>5 <SendStr>G^M Y^M <Delay>2 <MdmHangUp> <SetDTR> <SetDTR> on <SetDTR> off Assert or Reset UART Bit for data terminal ready <SetLCtrl>STRING <SetLCtrl>8N1 <SetLCtrl>7E1 <SetLCtrl>7N1 Page 11 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <SetBaud>STRING <SetBaud>300 <SetBaud>1200 <SetBaud>2400 <SetBaud>4800 <SetBaud>9600 <SetBaud>19200 <SetBaud>38400 <SetBaud>57600 <SetBaud>115200 ----------------------- I/O Mostly Scripts Uses ----------------------- The sample MINIHOST.SCR included with the AceComm package demonstrates most of the macros in this manual. Remember that macros ending in _> require local keyboard input, so are not suited to un-attended scripts. Example: <MdmHangUp_> will prompt the user (Yes/no) where <MdmHangUp> hangs up with no (Yes/no) prompt <CheckMdm>STRING This macro checks to see if STRING has come in from the modem. The macro does not wait, but sets the result for a following <if> to 1 or 0. Result to <if> is 1 or 0 --- Example --- ; ; Clear screen, Send ansi video request, Display banner ; <Timer0>3 ; Init Timer0 and set 3 second timeout <RawCapture>On ; Allow all caller's input in wait buffer ; ESC[6n is video request (detect ansi) <SendStr>^L^[[6n^MMini Host Script for AceComm v1.85^M ; ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence ; :@@DetectAnsi <CheckMdm> [ <if>1 <goto>@@AnsiDetected ; Remote will answer with <Timer0> <if>1 <goto>@@DetectAnsi ; ESC[n;nR if ANSI capable <RawCapture>Off <HostEcho>ON ; HostEcho translates CR ; into CR,LF pair <DispStr>^MAnsi video request un-answered^M ; Ansi video request <goto>@@Welcome :@@AnsiDetected <RawCapture>Off Page 12 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <HostEcho>ON ; HostEcho translated CR into CR,LF pair <SendStr> ^MAnsi video detected!^M --- End Example --- <DirList> PATH\*.* List a directory, can be used from host mode. <DirList>[DIR_DNLDS]\*.* <DirList>C:\files\*.ZIP <DispStr>TEXT <DispStr>^M[BWhi][Blu]Hello to you![AttrOff]^M^J <DispText> LABEL_NAME Display text defined in a data area of a script file LABEL_NAME is descriptive text following {-TEXT_START-} Text is displayed at current cursor position Text display is local --- Example --- :@@Top <ClrWin> <DispText>Intro <DispText>Ask_Continue :GetKey <GetKey>60 <if>Y <goto>Dial <if>N <goto>End <goto>GetKey :Dial <INITFONREC>ACECOMM Support BBS ; Initialize a FON RECORD <FON_NUM>1-602-846-2940 ; <FON_BAUD>19200 ; <FON_TERM>Av/An ; <FON_REDIAL> ; Go into re dial mode <DispText>Connect <WAITSTR> your name: <GetDCD> ; <WaitStr> may have timed <if>1 <goto>Connect ; out <goto>@@Top :Connect <SENDSTR>Michael Phelps^M <SENDSTR>Y^M <SENDSTR>password^M <WAITSTR>Select: <SENDSTR>ff :End <ENDS> Page 13 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ {-DATA_AREA-} {-TEXT_START-}Intro -- Generic Log On Script -- {-TEXT_END-} {-TEXT_START-}Ask_Continue Continue (Y/n) {-TEXT_END-} {-TEXT_START-}Connect -- Connect -- {-TEXT_END-} --- End Example --- <EndS> Marks the exit point for the script processor. <FindUser> Searches a file names USERLIST.LST for user names. Result to <if> is 1 or 0 Sample USERLIST.LST file contents: Michael Phelps,password,9 Guest Pass,guest,1 The user name must be First Last,password,level Level is not currently supported, but must be there. The commas are important. --- Example --- <DispStr> ^MEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr> ^MEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr> ^MEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd :@@1 <DispStr>^L^MYour name has not been registered in the user file, you may <DispStr>^Moptionaly leave a short not for the SysOp, pleas include your <DispStr>^Mfirst and last name along with a password. <DispStr>^M^MWould you like to leave a note? (Y)es/(N)o <GetKey> <if>Y <goto>@@LogOffComment <if>N <goto>@@OFF <Goto>@@1 --- End Example --- <GetKey>n <GetKey>60 The macro excepts a parameter. Seconds to wait for a key press. The Page 14 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ parameter range if 1 second - (60 * 7) seconds :@@Top <DispText>Main_Menu :@@GetKey <GetKey>10 <If>L <goto>@@List <If>M <Goto>@@Main <If>^M <Goto>@@Top <GetDCD> <If>0 <goto>@@UseDroppedCarrier <Goto>@@GetKey When a key press is checked with the <if> macro, it is first made upper case. Control characters can be trapped by representing it as ^[character]. To see if the user pressed the ENTER key <if>^M ESC key <if>^[ <if> will also check for extended key presses that might be made locally. This needs <LocalKeys>ON. <If>ALT+J <Goto>@@JumpToDOS <If>CTRL+J <Goto>@@JumpToDOS <If>F11 <Goto>@@JumpToDOS <If>SF11 <Goto>@@JumpToDOS <If>CF11 <Goto>@@JumpToDOS <If>AF11 <Goto>@@JumpToDOS <GetMsg> This macro will create a message. It needs host echo on. The macro inputs for From:, To:, Subject: fields. When called after <FindUser> the From: field is initialized with the user's name. The macro write a message header to the beginning of the message file. The message text is taken from the screen after the user saves the message with CONTROL Z. Message filenames are created as 1.MSG, 2.MSG, 3.MSG etc. The macro is designed for a small number of messages. It will create the first filename that does not exist. See <ReadMsg> and <YourMsg> macros. <GetStr>n <GetStr>36 Parameter n is the maximum characters to allow entered. Range is 1 - 128. The macro is used for the <FindUser>, <UserPwd>, and %FN. %FN maximum length is 80 characters. %FN always represents the string entered with <GetStr>. <DispStr> ^M^JEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr>^M^J^G%FN not found in user list! <Goto>@@DumpCaller :@@GetPwd Page 15 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <GoTo> Can be used alone or after an <If> macro. Parameter to <GoTo> is a label. Labels begin with a :. Labels need to be unique character strings. <GoTo>@@Done <GetDCD> <if>1 <Goto>@@Carrier <Goto>@@OffLine <CheckMdm>password: <if>1 <Goto>@@SendPwd <If> Can only be used after macros that produce a result. <GetDCD> <if>1 <Goto>@@DCD <CheckMdm> <If>0 <Goto>@@WaitStr <Timer0> <If>1 <Goto>@@WaitStr <Timer1> <If>0 <Goto>@@Timeout <FindUser> <If>0 <Goto>@@DumpCaller <UserPwd> <If>0 <Goto>@@LetCallerLeaveMsg <GetKey> <If>^M <Goto>@@UserEnter <LocalKeys> <LocalKeys> on <LocalKeys> off <LocalKeys> 3 way macro Enable/disable local LUI key press during script (host mode) <NCWaitStr> STRING Non CaSe sensitive version of <WaitStr> Waits for a string (sequence of characters) to come in the from the modem. Can Timeout. If <WaitStr> times out, it falls through. Timeout seconds is set with <WaitTime>n <WaitStr> name: | leading <SP> character is part of search <ReadMsg> This macro displays the messages found. A key press is prompted between each message. <SendStr> STRING Page 16 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Sends a string to the modem. <SendStr>^M Send a single CR_CHAR <SendStr> Michael Phelps^M Notes: the leading space character is part of STRING <SendStr>[USER_NAME]^M~Y^M~[FON_PWD] Send IEMSI data user name field, a <CR> char, 1 second pause, Y, <CR> char, 1 second pause, current Fon.Record.Password. <SendStr>[USER_NAME]^M^M[PASSWORD]^M Send IEMSI data user name field, 2 <CR> chars, IEMSI data password field. <Timer0> <Timer1> Two separate timers A parameter to the <Timer0> macro sets the timeout time in seconds Result to <if> is 1 or 0 <Timer0>30 Sets a timeout of 30 seconds for Timer 0 <Timer0> Sets the result for an <if> to 1 or 0. 0 if the timer has expired, <Timer1> works the same way. <UserPwd> This macro can only be called immediately after the <FindUser> macro. This macro will verify the password. Success or failure is determined with the immediate call to <if> macro. (see below) Result to <if> is 1 or 0 --- Example --- <DispStr> ^MEnter password: <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu <DispStr> ^MEnter password: <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu <DispStr> ^MEnter password: <GetStr>26 <UserPwd> <if>0 <goto>@@OFF <goto>@@MainMenu --- End Example --- Page 17 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <Var0> <Var1> Variables that can store a result. --- Example --- ; ; Clear screen, Send ansi video request, Display banner ; <Var0>0 ; See if we can set this to 1 with ; our ansi video detection scheme. <Timer0>3 ; Init Timer0 and set 3 second timeout <RawCapture>On ; Allow all caller's input in wait buffer ; ESC[6n is video request (detect ansi) <SendStr>^L^[[6n^MMini Host Script for AceComm v1.85^M ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence ; :@@DetectAnsi <CheckMdm> [ <if>1 <goto>@@AnsiDetected ; Remote will answer with <Timer0> <if>1 <goto>@@DetectAnsi ; ESC[n;nR if ANSI capable <RawCapture>Off <HostEcho>ON ; HostEcho translates CR ; into CR,LF pair <DispStr>^M^JAnsi video request un-answered ; Ansi video request <goto>@@Welcome :@@AnsiDetected <Var0>1 <RawCapture>Off <HostEcho>ON ; HostEcho translated CR into CR,LF pair <SendStr> ^M^JAnsi video detected! :@@Welcome ; ; %C is the connect speed ; <Var0> <if>1 <DispStr>^M^J[Whi]Connected at [Blink][Bold][Red]%C[AttrOff] <Var0> <if>0 <DispStr>^M^JConnected at %C --- End Example --- <WaitStr> STRING Waits for a CASE sensitive string (sequence of characters) to come in the from the modem. Can Timeout. If <WaitStr> times out, it falls through. Timeout seconds is set with <WaitTime>n <WaitStr> name: | leading <SP> character is part of search Page 18 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Character I/O Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <WaitTime> n Where n is in seconds Set the timeout value for <WaitStr> (default is 40 seconds) <Timer0>10 <WaitTime>15 <WaitStr>name? <Timer0> <if>0 <goto>@@Timeout <SendStr>[USER_NAME]^M :@@TimeOut <YourMsg> This macro is the same as <ReadMsg>, except that the To: field in the message header must match the caller's name. You can use this macro to display personal messages to the callers. Messages must be created with <GetMsg>. Page 19 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Flags ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ ------------------------ Internal Protocols Flags ------------------------ <AutoD> on/off Enable/disable auto engage sequence scanning for protocols Does not affect auto log on <Resume> on/off Enable/disable file resume (internal zmodem receive) <Rename> on/off Enable/disable file rename (internal zmodem receive) ------------- General Flags ------------- <SwapSpawn> on/off 3 way toggle Enable/disable swap to EMS/XMS/DISK for <RunProg> macro <SwapShell> on/off 3 way toggle Enable/disable swap to EMS/XMS/DISK for <CommandShell_> macro <DTRExit> on/off 3 way toggle DTR state for <EndAceComm> macro <Scheds> on/off <Scheds>ON ; Enable <Scheds>OFF ; Disable <Scheds> ; Toggle 3 way toggle This macro will simply turn the schedules on or off. Page 20 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ File Functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <ChgDir> FILENAME Make FILENAME current directory This macro can change drives <ChgDir>C:\WORK\TXT <ToPrn>melissa.01 <ChgDir>[DIR_START] <ChgDir>[FIR_DNLDS] <RunProg>DSZ port %P speed %B rz -mr <ChgDir>[DIR_START] Notes: [DIR_START] is the directory Acecomm is started in. [DIR_DNLDS] is the directory pointed to inside PRM-data "Directories" menu for "Downloads". <CloseCapture> Close the current open capture file, or just returns if none is open. Capture files are stamped with date/time when closed. Capture files are automatically closed on detection of a loss in carrier. Capture files are automatically closed when the <OpenCapture> macro is called, so that any previous open capture file is sure to be closed before opening the new one. <FileDel> FILENAME If the file exists, it will be deleted without prompt. Use full path name if not in current directory. <LogFile> text Adds "text" to ACE.LOG <OpenCapture> FILENAME Calling this function opens a capture file in the directory path defined inside PRM-data Area "Directories" menu, .CAP files. Existing capture files of same FILENAME are appended to. DOS eof character may end up just ahead of the time stamp. This function will first close any previously opened capture file, properly saving it to disk. Capture files are stamped with date/time when opened. Capture files can record either in "Raw" or "Text" mode. "Raw" mode being Page 21 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ File Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ where no video control characters are filtered. "Text" being everything that the current video emulation does not pick out. See also <RawCapture> macro <RawCapture>on/off <RawCapture>on <RawCapture>off <RawCapture> 3 way toggle <rawCapture>ON <OpenCapture>xmas.ans Captured data will be stored with or without video control characters. The current video emulation must mach that of the host. AN/AV covers both Ansi and Avatar video at the same time ans is the AceComm default video type. <RunScript> FILENAME Open and run FILENAME Notes: Just FILENAME no PATH. PATH found in PRM-data for SCR directory is used. Note the difference between <RunScript> and <RunScript_>, where the later does filename prompting. <RunProg> FILENAME Spawn an executable file. Can search the DOS PATH. Can determine files's extension (.COM, .EXE). All system ISRS are restored before the spawn takes place. The serial port is un-hooked. The state of DCD, and LINE CONTROL are left in tact. After the spawn the system ISRs AceComm uses are taken back, the serial port is re-assumed. SWAP FLAG "ON" and XMS,EMS, or DISK swapping takes place. SWAP FLAG "OFF" and AceComm is left in memory, with exception to first restoring the serial port and interrupts. <SetFonFile> FILENAME Tacks FILENAME onto the PATH defined in PRM DATA for .FON files. AceComm keeps track of the current(last accessed) .FON file. FILENAME becomes the current .FON file. <SetFonFile> 1_114.fon <DialRecord> 1 Page 22 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ File Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <ToPrn> FILENAME Send FILENAME to the printer. Notes: This macro opens the filename PRN using DOS file handle function, and writes the file. Any character translation DOS may do will depend upon the IOCTL functions of DOS. (eof etc.) Page 23 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Data Transfer functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Internal receiver protocols will receive to the sub directory for Downloads as setup inside the PRM-data "Directories" menu. <SendAscii> FILENAME Outputs from a file to the modem. Sends the complete file. Does *NO* CONTROL CHARACTER TRANSLATION. Data sent to the modem is paced for buffer FULL, and all handshaking is valid. ESC-key press aborts the function. <SendZmo@> @FILENAME Where @FILENAME is a LISTFILE The @ denotes a LISTFILE Filenames contained in the listfile should be full drive path filenames, if not all contained in the current working directory. Call internal zmodem sending unit with 1k data frame size. ESC-key press aborts the function. <SendZmo> FILENAME Call internal zmodem sending unit with 1k data frame size. ESC-key press aborts the function. <SendYmo> FILENAME Call internal ymodem sending unit with 128 byte data frame size. ESC-key press aborts the function. <SendYmo1k> FILENAME Call internal ymodem sending unit with 1k data frame size. ESC-key press aborts the function. <SendYmoG> FILENAME Call internal ymodemG sending unit with 1k data frame size. ESC-key press aborts the function. <SendXmo> FILENAME Call internal xmodem sending unit with 128 byte data frame size. ESC-key press aborts the function. Page 24 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Data Transfer functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <SendXmo1k> FILENAME Call internal xmodem sending unit with 1k data frame size. ESC-key press aborts the function. <RecvAscii> FILENAME Ascii receiver will close the file when End Of File "eof" character is seen. Eof character is set from inside "Protocol Options" menu. The default eof character is the DOS standard 26d. ESC-key press aborts the function. <RecvZmo> Call internal zmodem recv unit. AceComm's internal zmodem receiver is capable of up to 8k data frame size. The receive unit will continue in batch mode until the sender stops sending files, or the user terminates the transfer. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. <RecvYmo> Call internal ymodem. The receive unit will continue in batch mode until the sender stops sending files, or the user terminates the transfer. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. <RecvYmo1K> Call internal ymodem1K. The receive unit will continue in batch mode until the sender stops sending files, or the user terminates the transfer. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. <RecvYmoG> Call internal ymodemG. The receive unit will continue in batch mode until the sender stops sending files, or the user terminates the transfer. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. <RecvXmo> FILENAME Call internal xmodem. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. Page 25 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Data Transfer functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <RecvXmo1K> FILENAME Call internal xmodem1k. Files are placed into the directory pointed to in the PRM-data area for Downloads. ESC-key press aborts the function. <SendEMSI_CLI> Send an EMSI_CLI HDR sequence to modem BBS mailer front ends that use EMSI handshake protocol will, if EMSI is implemented properly, interpret an "EMSI_CLI" HDR sequence, as "this is a human caller" and drop to the BBS without any delay. Note: At this writing Front Door, and Binkley recognize EMSI_CLI HDR. DBridge does not. See default AutoD trigger assignments (ACE.CTL) <SendEMSI_ICI> IEMSI support macro Send an EMSI_ICI data packet to modem EMSI_ICI is a response made by the caller (CLIENT) to a BBS system (HOST) which supports Interactive EMSI handshake protocol. IEMSI data is contained inside the PRM-data area. This data can be used for automating log on when call a BBS that supports IEMSI. See default AutoD trigger assignments (ACE.CTL) Notes: Xmodem/Ymodem Receive units are capable of adopting to frame size. 128 / 1024 data frames are determined by the sender and can be sent in any combination. The Internal Zmodem in AceComm is capable of up to 8k data frames. For compatibility, AceComm only uses larger than 1k data frames with it's sending unit in mailer modes. AceComm's zmodem receive unit can handle up to 8k data frames at any time. The internal zmodem can make filename management decisions based on the status of option flags for "resume" and "rename". Page 26 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Dialing/Fon.Record ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <DialNum> PHONE_NUMBER Builds a dial string. Uses PRM-data MDM_DIAL_PREFIX and PHONE_NUMBER Sends the dial string to the modem. One time. No re dials as this will typically take place from terminal area. <DialRecord> n Retrieves the n record found in current .FON file Re dials number until CONNECT or USER ABORT <SetFonFile> 1_114.FON <DialRecord> 1 ----------------------------------------- For creating a Fon.Record inside a script ----------------------------------------- <InitFonRec> RECORD NAME This MACRO must be called first. The MACRO initializes a FON RECORD with AceComm defaults. RECORD NAME is copied into the system name for this record. <InitFonRec> Compuserve <Fon_Num> PHONE_NUMBER Set the phone number field. Any dial statements in ACE.CFG will be applied to this number when AceComm builds the dial string. <Fon_Num>468-0285 <Fon_Baud>BAUD If using a locked port, AceComm will ignore this value when getting ready to dial. <Fon_Baud>19200 <Fon_LineCtrl> DATA_PARITY_STOPBIT Valid parameters are as follows 8n1 7e1 7n1 Page 27 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Dialing/Fon.Record (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <Fon_LineCtrl>8n1 <Fon_Flags> FLAG, FLAG Possible Control Flags "Script" when set, AceComm will attempt to load and run the filename defined next to "AutoLogOn Script". If a script file is not found, AceComm ignores the error and continues normal operation. Notes: .SCR files are looked for in the directory defined inside PRM-data Area "Directories" "Macro" when set, AceComm will enable the defined Auto Log on Sequence Triggers and corresponding MACRO stacks. "DTag" when set, AceComm will tag un-successful dial attempts (busy, etc.) to the Que Dialer. An "*" character appears to the left of a Fon.Record's display line, when it is either Q tagged or, D tagged. When this flag is not set, the only other way to Q tag a record is by manually selecting the menu option "<SPACEBAR>-Que" from the fon list display. "Capture" when set, When this flag is selected, a capture file is opened upon Dial/Connect. Any previously open capture file is first closed. "Raw" when set, Data to capture file is as it comes in from the modem "Text" when set, Data to capture file is filtered of video control codes as applicable to the current Video type "IEMSI" when set, Allow Interactive EMSI log on "AutoL" Page 28 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Dialing/Fon.Record (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Allow auto log on methods (script/macro) <Fon_Term> VIDEO_TYPE - Valid parameters are as follows TTY Ansi Avatar Av/An VT102 <Fon_Term>Av/An <Fon_CapFile> FILENAME <Fon_Redial> Presents the FON record to the AceComm re dial function. <Redials>n Where n is the number of redials before giving up. This macro works only when dialing from a script using the <FON_ReDial> macro. <ReDials> does not affect normal interactive use, and is not the same as the menu option found inside the "Point Mail" "Options" menu. Page 29 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Misc Functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <Alarm> SECONDS Sound alarm for SECONDS <BbsEndAceComm> This macro will Exit AceComm with an error level based on the current baud setting. Baud is taken from the UART, and if the port is locked, will vary from the connect speed. Error level is decimal of the first 2 ascii decimal digits of the current UART baud setting. DTR state is left as is. Error levels returned are: 57 - 57600 38 - 38400 19 - 19200 96 - 9600 48 - 4800 24 - 2400 12 - 1200 30 - 300 Sample use: :Start echo off ace if error level 96 goto error96 if error level 57 goto error57 if error level 48 goto error48 if error level 38 goto error38 if error level 24 goto error24 if error level 19 goto error19 goto start :error57 BBS.EXE 57600 goto Start :error38 BBS.EXE 38400 goto Start :error19 BBS.EXE 19200 goto Start :error96 BBS.EXE 9600 goto Start :error48 BBS.EXE 4800 goto Start :error24 BBS.EXE 2400 Page 30 Chapter 2 Macros list ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Misc Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ goto Start :error12 BBS.EXE 1200 goto Start :End <ClrWin> Clear screen. Clears screen above status line <Delay> SECONDS Create program function delay. <SendStr>Go IBMCOM^M <OpenCapture>ibmcom <Delay>7 <SendStr>Read New^M <Delay> allows I/O, you could trip your <CheckMdm> with this one. <EndAceComm> ERROR LEVEL <EndAceComm> 0 AceComm session end with error level Exit AceComm back to the operating system. End AceComm session. A QUICK snap, no prompt "Are you sure?". If your on line, your still on line when you come back unless "drop DTR on exit is SET" See Drop DTR on EXIT flag inside Terminal Area Options Notes: Pressing CONTROL BREAK will always end AceComm. CONTROL BREAK is a back door to the <EndAceComm> macro. When you exit the program by pressing CONTROL BREAK, all data is saved as usual, and program cleanup is as it would be using the <EndAceComm> macro. <PollHost>1-5 This macros take Host data and builds a FLO file. The macro then creates a Fon.Record with the BOSS info and goes into mailer mode. If the connect is un-successful or aborted, the FLO file still exits in the MAIL OUT directory. Any schedule that allows mail will see the FLO file and cause the system to be polled again. Long distance calls need the "LD," schedule flag, <RingBell> SECONDS A value of 0 does not ring bell, a value of 1 plays a victory tune, values from 2 - 30 ring the internal bell for the number of seconds. This is the same bell sound heard in the Dial/Connect window. <Wait_To_HHMM> hh:mm Page 31 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Misc Functions (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Wait until hour:minute 24 hour format leading zeros not needed <Wait_To_HHMM>4:10 is valid --- Example --- <Wait_To_HHMM>15:45 ; wait till 3:45 pm <INITFONREC>A.C.E. Software Support; call Init FON function <FON_NUM>1-602-846-2940 ; set phone number <FON_BAUD>2400 <FON_TERM>Av/An ; video type for script <FON_REDIAL> ; call redial function <WAITSTR>it a few moments. <SENDSTR>^M <WAITSTR>s your name: <SENDSTR>Michael Phelps^M <WAITSTR>ael Phelps [Y,n]? <SENDSTR>^M <WAITSTR>Password: <SENDSTR>melissa_jean^M <WAITSTR>Select: <SENDSTR>f^M <SENDSTR>d^Mz^Mace170.arj^M <RecvZmo> <WAITSTR>Select: <SENDSTR>gyn^M <ENDS> --- End Example --- Page 32 Chapter 2 Macros list Chapter 3 MACRO Parameter Symbols Page 33 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ o MACRO parameters are UPPER case only [MODA] Replaced with mmdd (month day) 0704 (July 4) Good for frequently used filesnames. Assigning a Fon.Record capture filename to something like CIS[MODA] would result in a unique filename for each differant day you log onto Compuserve. Another example: <OpenCapture>CIS[MODA] ----------- Fon.Records ----------- [FON_PWD] Replaced with the current Fon.Record "password" [FON_ALIAS] Replaced with the current Fon.Record "alias" [FON_ID] Replaced with the current Fon.Record "ID" [FON_CAP] Replaced with the current Fon.Record CAPTURE "filename" [FON_SCR] Replaced with the current Fon.Record SCRIPT "filename" -------------- PRM-data IEMSI -------------- [USER_NAME] Replaced with the current PRM-data/IEMSI "User Name" <SendStr> [USER_NAME] [ALIAS] Page 34 Chapter 3 MACRO Parameter Symbols ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Replaced with the current PRM-data/IEMSI "alias" [LOCATION] Replaced with the current PRM-data/IEMSI "location" [DATA_PNUM] Replaced with the current PRM-data/IEMSI "data #" [VOICE_PNUM] Replaced with the current PRM-data/IEMSI "voice #" [PASSWORD] Replaced with the current PRM-data/IEMSI "password" The following are data from PRM-data DIRECTORY section -------------------- PRM-data Directories -------------------- [DIR_START] Replaced with the current PRM-data/DIR "start up" This is the directory AceComm is started in. [DIR_FON] Replaced with the current PRM-data/DIR ".FON" [DIR_CAP] Replaced with the current PRM-data/DIR ".CAP" [DIR_SCR] Replaced with the current PRM-data/DIR ".SCR" [DIR_KTS] Replaced with the current PRM-data/DIR ".KTS" Page 35 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ [DIR_DNLDS] Replaced with the current PRM-data/DIR "dnlds" <ChgDir> [DIR_DNLDS] <RunProgram>DSZ rz -mr <ChgDir> [DIR_START] [DIR_NODELIST] Replaced with the current PRM-data/DIR "nodelist" [DIR_MAILIN] Replaced with the current PRM-data/DIR "mail_in" [DIR_MAILOUT] Replaced with the current PRM-data/DIR "mail_out" -------------- PRM-data Modem -------------- [MDM_INIT] Replaced with the current PRM-data/MDM "init" <SendStr>[HANGUP]^M~[MDM_INIT]^M [DIAL_PREFIX] Replaced with the current PRM-data/MDM "dial prefix" [DIAL_SUFFIX] Replaced with the current PRM-data/MDM "dial suffix" [ANSWER] Replaced with the current PRM-data/MDM "answer" [HANGUP] Replaced with the current PRM-data/MDM "hangup" [OFFHOOK] Page 36 Chapter 3 MACRO Parameter Symbols ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Replaced with the current PRM-data/MDM "off hook" [ABORT] Replaced with the current PRM-data/MDM "abort" [RESET] Replaced with the current PRM-data/MDM "reset" [ECHO] Replaced with the current PRM-data/MDM "echo" [HOST_INIT] Replaced with the current PRM-data/MDM "host init" [CMD_LINE_TERMINATOR] Replaced with the current PRM-data/MDM "command line terminator" ------------------------ Ansi Video Control Modes ------------------------ [AttrOff] All attributes Off, reset to gray [Bold] Bold color attribute [Faint] Faint color attribute [Italic] Italics text on [Blink] Blinking attribute on Page 37 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ [RBlink] Rapid blinking attribute on [Rev] Reverse video attribute on [Con] Concealed attribute ------------------------- Ansi Video Control Colors ------------------------- The following foreground colors become intense with [Bold], and normal with [Faint]. Replaceable macro Foreground Color ----------------- ---------------- [Bla] Black [Red] Red [Gre] Green [Yel] Yellow [Blu] Blue [Mag] Magenta [Cya] Cyan [Whi] White Replaceable macro Background Color ----------------- ---------------- [BBla] Black [BRed] Red [BGre] Green [BYel] Yellow [BBlu] Blue [BMag] Magenta [BCya] Cyan [BWhi] White ------------------------- Ansi Video Cursor Control ------------------------- Replaceable macro Background Color ----------------- ---------------- Page 38 Chapter 3 MACRO Parameter Symbols ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ PRM-data Representatives (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ [CUp] Cursor Up 1 [CDn] Cursor Down 1 [CFw] Cursor Right 1 [CBw] Cursor Left 1 [Cls] Clear Screen [Cle] Clear to End Of Line -------------- Host Mode Data -------------- [USR_NAM] Caller name as found in the USERLIST.LST file. [CURTIME] Replaced with the current time in 12 hour format. [DCDTIME] Replaced with the online time. [EMINUTE] Replaced with ascii decimal minutes untill next event Page 39 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Replaceable Macro Functions ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ o Replaceable MACRO Functions are UPPER case only %B Insert ascii baud, %B is replaced with current baud setting in ascii format. Current baud setting is UART line speed, if the port is locked, this will differ from the modem connect speed. %C Insert ascii connect speed, same as above, but CONNECT speed in stead of port rate. %P Insert ascii port, %P is replaced with current port number is ascii format. Port number is 1 based (com1 =1, com2 =2) %FN (Valid when used from <FileLister_>) Use from File Lister Area, %FN is replaced with currently "highlighted" filename. %PF Prompt for filename, %PF is replaced with what you type into the prompt box. %WK Wait for Key press, stops MACRO execution and waits for a key press. Page 40 Chapter 3 MACRO Parameter Symbols Chapter 4 Scripts Page 41 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AutoScriptGen (Tm) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AceComm generates script files automatically when running in "AutoScriptGen" mode. The macro <AutoScrGen_> puts AceComm into "Script Learn". AceComm's default keyboard file, assigns ALT A to toggle <AutoScrGen_> on. "AutoScriptGen" first prompts for a filename to use for the script file. The extension .SCR will automatically be appended. …ÕInput WindowÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ∫ÕEnter filename, <ENTER> alone when done, ESC-abortÕÕÕÕÕÕÕÕÕÕÕÕ ∫>=> D:\ACE\CSERVE∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞∞ »ÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ Having a filename, AutoScriptGen creates the file and waits for activity. We want to call out. Lets bring up the FON directory and select Compuserve. …Õ Telephone_directory fon\ACE.FON, 9 RecordsÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕÕ ∫Õ System Name Phone Number Line Control V ∫ 1 AceComm Support BBS 1-602-846-2940 19200,8N1 A ∫>2 CIS (local phoenix 9600) 468-0285 19200,7E1 A ∫ 3 CIS (phones) 1-800-346-3247 2400,7E1 A ∫ 4 Comp USA #2 1-214-620-7993 19200,8N1 A ∫ 5 Supra Modem BBS 1-503-967-2444 19200,8N1 A ∫ 6 - Comput Connections (PCB) 1-202-547-2008 19200,8N1 A ∫ 7 - Comp USE (Dallas TX) 1-214-620-2255 19200,8N1 A ∫ Dial Edit <SPACEBAR>-Que Circling_dial_queue Fon_files S »Õ Add_record Remove_record UnMark_All Import Paint Quit H AutoScripGen will write Fon.Record information to the script file in the form of macro commands. The macro to start "Script Learn" is <AutoScrGen>. AceComm's default setup uses ALT A to toggle <AutoScrGen> on. The following short scrip is exactly as was recorded by the "Script Learn" function. <INITFONREC>CIS (local phoenix 9600) <FON_NUM>468-0285 <FON_LINECTRL>7E1 <FON_BAUD>19200 <FON_TERM>Av/An <FON_FLAGS>Macro,DTag,Cap,Text,IEMSI, <ReDials>100 <FON_REDIAL> <LocalKeys>On <OPENCAPTURE>cserve.CAP <SendStr>^M <WaitStr>Host Name: <SendStr>cis^M <WaitStr>User ID: <SendStr>75120,3306^M <WaitStr>Password: <SendStr>your/pwd^M <WaitStr>r HELp! Page 42 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AutoScriptGen (Tm) (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <SendStr>rea^M <WaitStr>e(s) # (or ALL)?! <SendStr>all^M <WaitStr>CR> for more ! <SendStr>^M <WaitStr>CR> for more ! <SendStr>^M <WaitStr>CR> for more ! <SendStr>^M <WaitStr>e, REPly or NEXt! <SendStr>^M <WaitStr>CR> for more ! <SendStr>^M <WaitStr>CR> for more ! <SendStr>^M <WaitStr>e, REPly or NEXt! <SendStr>^M <WaitStr> ADDress or HELp! <SendStr>^M <WaitStr>ssages? (Y or N)! <SendStr>n^M <WaitStr>Enter choice ! <SendStr>go IbmPro^M <CLOSECAPTURE> <OPENCAPTURE>ibmpro.CAP <WaitStr>CR> ! <SendStr>Read New^M <WaitStr>CR> ! <SendStr>^M <CLOSECAPTURE> <WaitStr>Enter choice ! <SendStr>off^M <WaitStr>Host Name: <SendStr>off^M <ENDS> To begin "Script Learn", I pressed ALT A for <AutoScrGen>. This macro will turn on "Script Learn" and prompt you for a filename. Type in the filename for the new script. Next, I pressed ALT D for <PhoneList>, and selected the local 9600 CIS record for dialing. This segment was written to the script when entering the dialer. <INITFONREC>CIS (local phoenix 9600) <FON_NUM>468-0285 <FON_LINECTRL>7E1 <FON_BAUD>19200 <FON_TERM>Av/An <FON_FLAGS>Macro,DTag,Cap,Text,IEMSI, <ReDials>100 <FON_REDIAL> <LocalKeys>On <OPENCAPTURE>cserve.CAP Page 43 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AutoScriptGen (Tm) (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ The dialer sees we are in "Script Learn" and writes the macros required to initialize a Fon.Record. Notice the "Flags" include opening a capture file upon Dial/Connect. The "Cap," flag was recorded here, and is responsible for the "<OpenCapture>cserve.CAP" to be recorded into the script. Because the <OpenCapture> macro has been recorded, we want to edit out the "Cap," flag. If we leave it in, the capture file will be opened twice, it not be a problem, except for duplicate time stamps. It is nice to have a capture file open while recording in "Script Learn", a capture file provides a good reference later on when editing the script. What follows is a script that captures a forum (IBMPRO) to a capture file, and also checks for "Compuserve Mail" along the way. I have CIS configured to announce my mail, and so some decision making is required for the scripts to operate all the time. The fastest way for me to read a forum is to capture it to file 2 or 3 times a week. I can reply off line. Since personal mail announcements are capable of tripping up a script, like the one generated above, some more complex macros are put to work. ; We can place comments into our scripts. ";" is used as a comment ; character. Text following ";" is a comment. <DispStr>[AttrOff] <ClrWin> <DispStr>[BWhi][Blu] <DispText>Intro <DispStr>[AttrOff] <DispStr>^M^JQ)uit <DispStr>^M^JAny key continues, or wait 10 seconds^M <GetKey>10 <if>Q <Goto>@@EndScript <INITFONREC>CIS (local phoenix 9600) <FON_NUM>468-0285 <FON_LINECTRL>7E1 <FON_BAUD>19200 <FON_TERM>Av/An <FON_FLAGS>Macro,DTag,Text,IEMSI, ; I deleted "Cap," from the flags <ReDials>100 ; This macro gives control over how many ; times to re-dial before giving up. <FON_REDIAL> <LocalKeys>On <OPENCAPTURE>cserve.CAP ; Note: when stacking macros, a space character MUST precede the macro. <SendStr>^M <WaitTime>15 ; 15 seconds to timeout (<WaitStr> only) <WaitStr>Host Name: <SendStr>cis^M <WaitStr>User ID: <SendStr>75120,3306^M <WaitStr>Password: <SendStr>your/pwd^M ; The following checks for personal messages, "Compuserve Mail". ; waiting for me. I won't have messages waiting every time I log on to ; Compuserve. We need a way for the script to make decisions. If there are ; messages, we can stop and read them, recording them into the already open ; capture file, if no messages, we want to continue to capture the forum, and ; log off. Page 44 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AutoScriptGen (Tm) (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <Timer0>30 ; Set a timer to 30 seconds :@@CheckMail ; Label we loop to while checking <CheckMdm>CompuServe Mail <if>1 <goto>@@PersonalMail <CheckMdm>messages pending <if>1 <goto>@@PersonalMail <CheckMdm>SCAn, REAd, <if>1 <goto>@@PersonalMail <CheckMdm>Enter choice ! <if>1 <goto>@@CompuserveTop <Timer0> <if>1 <Goto>@@CheckMail ; <if>1 while not timed out ; ; Fall through to the forum on timeout ; <SendStr>^M <Goto>@@IBMPRO ; ; Here if we got a hit with <CheckMdm>. <CheckMdm> is not case sensitive. ; :@@PersonalMail <WaitTime>10 ; New, faster timeout for <WaitStr> <OPENCAPTURE>cismail.CAP ; <WaitStr> falls through on timeout <SendStr>Read^M <WaitStr># (or ALL)?! <SendStr>all^M <Timer0>300 ; 5 minutes till timeout, up this if you are popular :@@ReadMail <CheckMdm>CR> for more ! <if>1 <SendStr>^M <CheckMdm>REPly or NEXt! <if>1 <SendStr>Next^M <CheckMdm>SCAn, REAd, <if>1 <SendStr>^M <CheckMdm>CR> for more ! <if>1 <SendStr>^M <CheckMdm>Delete these messages? (Y or N)! <if>1 <goto>@@AfterMail <Timer0> <if>1 <goto>@@ReadMail ; ; Fall through to here on timeout ; :@@AfterMail <SendStr>N^M <Timer0>60 ; Here we use 2 timers in 2 loops :@@CompuserveTop :@@ResetTimer1 <Timer1>10 :@@TenSecondLoop <CheckMdm>Enter choice ! <if>1 <goto>@@IBMPRO <CheckMdm>Last page ! <if>1 <SendStr>^M <Timer1> <if>1 <goto>@@TenSecondLoop <SendStr>^M <Timer0> <if>1 <goto>@@ResetTimer1 :@@LogOff <SendStr>off^M <Delay>5 <SendStr>off^M <Delay>2 <MdmHangup> :@@IBMPRO <CLOSECAPTURE> <SendStr>go IbmPro^M <OPENCAPTURE>ibmpro.CAP <Delay>7 <SendStr>Read New^M <MdmStill>10 Page 45 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ AutoScriptGen (Tm) (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <CheckMdm>CR> ! <if>1 <SendStr>^M <CLOSECAPTURE> ; If you want more forums ; you can un-comment the following line <Goto>@@IBMCOM <WaitTime>15 <WaitStr>Enter choice ! <SendStr>off^M <WaitStr>Host Name: <SendStr>off^M <MdmHangup> <Goto>@@EndScript :@@IBMCOM <SendStr>go IBMCOM^M <OPENCAPTURE>ibmCOM.CAP <Delay>7 <SendStr>Read New^M <MdmStill>10 <CheckMdm>CR> ! <if>1 <SendStr>^M <CLOSECAPTURE> <WaitTime>15 <WaitStr>Enter choice ! <SendStr>off^M <WaitStr>Host Name: <SendStr>off^M <MdmHangup> :@@EndScript <ENDS> {-DATA_AREA-} {-TEXT_START-}Intro ⁄ƒƒƒƒƒƒ Compuserve Forums ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø ≥ ≥ ≥ This script calls Compuserve, and captures forums to their respectively ≥ ≥ named capture files. The script demonstrates some basic decision making ≥ ≥ using <CheckMdm> and <Timer0> macros. The script is capable of capturing ≥ ≥ personal mail, if any, and continue on to get the forums. ≥ ≥ The script will pause for 10 seconds after it has logged onto Compuserve. ≥ ≥ This pause is where we detect for any "Compuserve Mail" that may be ≥ ≥ waiting for us. ≥ ≥ ≥ ≥ You will need to edit the script where the login process sends your ≥ ≥ CIS ID and CIS password. ≥ ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ {-TEXT_END-} Page 46 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Labels, Gotos, Data Area ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ :Label Labels begin with ':' character Labels are used as arguments to the <goto> macro <goto> label "Label" can be defined any where in the script file, either before or after a <goto> macro. <if> condition AceComm supports a set of conditional macros. Conditional macros return either 1 or 0. {-DATA_AREA-} Defines a data area {-TEXT_START-} see examples {-TEXT_END-} {-Data_ Area-} will be covered extensively next month with many complex scripts as well as complete documentation. The following script introduces some un-documented script language features. Follows is a basic script which includes a data area. ------------snip here ------------- <ClearWindow> <DispText>Intro <DispText>Ask_Continue :GetKey <GetKey> <if>Y <goto>Dial <if>N <goto>End <goto>GetKey :Dial <INITFONREC>ACECOMM Support BBS ; Initialize a FON RECORD <FON_NUM>1-602-846-2940 ; <FON_BAUD>19200 ; <FON_TERM>Av/An ; <FON_REDIAL> ; Go into re dial mode <DispText>Connect <WAITSTR> your name: <GetDCD> ; <WaitStr> may have timed <if>1 ; out <goto>Connect <goto>Dial :Connect Page 47 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Labels, Gotos, Data Area (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <SENDSTR>Michael Phelps^M <SENDSTR>Y^M <SENDSTR>password^M <WAITSTR>Select: <SENDSTR>ff :End <ENDS> {-DATA_AREA-} {-TEXT_START-}Intro -- Generic Log On Script -- {-TEXT_END-} {-TEXT_START-}Ask_Continue Continue (Y/n) {-TEXT_END-} {-TEXT_START-}Connect -- Connect -- {-TEXT_END-} ------------snip here ------------- ------------snip here ------------- <Wait_To_HHMM>15:45 ; wait till 3:45 pm <INITFONREC>A.C.E. Software Support; call Init FON function <FON_NUM>1-602-846-2940 ; set phone number <FON_BAUD>2400 <FON_TERM>Av/An ; video type for script <FON_REDIAL> ; call redial function <WAITSTR>it a few moments. <SENDSTR>^M <WAITSTR>s your name: <SENDSTR>Michael Phelps^M <WAITSTR>ael Phelps [Y,n]? <SENDSTR>^M <WAITSTR>Password: <SENDSTR>melissa_jean^M <WAITSTR>Select: <SENDSTR>f^M <SENDSTR>d^Mz^Mace170.arj^M <RecvZmo> <WAITSTR>Select: <SENDSTR>gyn^M <ENDS> <ENDS> ------------snip here ------------- Page 48 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ;; ;; -- Mini Host Mode Script for AceComm v1.86 -- ;; ;; Note: Labels are CaSe sensitive ;; :@@Start will not be found if accessed as <goto>@@start ;; => S <= ;; Labels begin with ':' character, and start at the beginning ;; of a line ;; Each label must be a unique character string ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Back up here after caller ; ;;;;;;;;;; :@@Start ;;;;;;;;;; <HostEcho>OFF <SendStr>ATE0^M ; We do not want the modem to echo ; as AceComm handles this when we turn ; <Host_Echo>ON <AutoAnswer>On <LocalKeys>Off <SetDTR>Off <Delay>1 <SetDTR>On ; This will hang up most modems <SetLCtrl>8n1 ; new macro for 1.86 <Delay>2 ; This will help wait for modem response ; strings to clear <ClrWin> <DispText>TellAutoAnswer ; Display text defined in Data Area ; %P (port), %B (connect speed) <DispStr>Port %P Setup for %B^M^JWaiting for caller^M^J ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Top of wait for caller loop ; ;;;;;;;;;; :@@Wait ;;;;;;;;;; <DispStr>^M[CURTIME]^M <GetDCD> <if>1 <goto>@@DCDLogIn ; Here is where we detect a caller <GetKey>5 <if>L <goto>@@LogIn ; Allow local keyboard login <if>C <DOSShell_> <if>ALT+J <DOSShell_> <if>R <RunProg>list.com <if>E <goto>@@END ; Provide a clean exit <goto>@@Wait ; 'Wait' is a case sensitive label... ; ; Here if carrier detected ; :@@DCDLogIn ; Page 49 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ ; Clear screen, Send ansi video request, Display banner ; <Var0>0 ; See if we can set this to 1 with ; our ansi video detection scheme. <Timer0>3 ; Init Timer0 and set 3 second timeout <RawCapture>On ; Allow all caller's input in wait buffer ; ESC[6n is video request (detect ansi) <SendStr>^L^[[6n^MMini Host Script for AceComm v1.86^M ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Loop here for 3 second maximum waiting for answer to Ansi detect sequence ; :@@DetectAnsi <CheckMdm> [ <if>1 <goto>@@AnsiDetected ; Remote will answer with <Timer0> <if>1 <goto>@@DetectAnsi ; ESC[n;nR if ANSI capable <RawCapture>Off <HostEcho>ON ; HostEcho translates CR ; into CR,LF pair <DispStr>^M^JAnsi video request un-answered ; Ansi video request <goto>@@Welcome :@@AnsiDetected <Var0>1 <RawCapture>Off <HostEcho>ON ; HostEcho translated CR into CR,LF pair <SendStr> ^M^JAnsi video detected! :@@Welcome <Var0> <if>1 <DispStr>^M^J[Whi]Connected at [Blink][Bold][Red]%C[AttrOff] <Var0> <if>0 <DispStr>^M^JConnected at %C ; ; Caller names are pre registered into an ascii comment file "USERLIST.LST" ; Sample Line: Michael Phelps,acecomm,9 ; where "acecomm" is the password ; ;;;;;;;;;;; :@@LogIn ;;;;;;;;;;; <Var0> <if>1 <DispStr>[Whi] <DispStr> ^M^JEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr>^M^J%FN not found! <DispStr> ^M^JEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr>^M^J%FN not found! <DispStr> ^M^JEnter your first and last name: <GetStr>26 <FindUser> <if>1 <goto>@@GetPwd <DispStr>^L^M^JYour name has not been registered in the user file, you may <DispStr>^M^Joptionaly leave a short not for the SysOp, pleas include your <DispStr>^M^Jfirst and last name along with a password. <DispStr>^M^J^M^JWould you like to leave a note? (Y)es/(N)o :@@1 <GetKey>60 Page 50 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <if>Y <goto>@@LogOffComment <if>N <goto>@@OFF <Goto>@@1 :@@GetPwd <DispStr> ^M^JEnter password: <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu <DispStr> ^M^JEnter password: <GetStr>26 <UserPwd> <if>1 <goto>@@MainMenu <DispStr> ^M^JEnter password: <GetStr>26 <UserPwd> <if>0 <goto>@@OFF <goto>@@MainMenu :@@LogOffComment <HostEcho>ON ; This needs be on for message, even local <GetMsg> <Goto>@@OFF ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Top of main menu loop ; :@@MainMenu <DispStr>^L <Var0> <if>1 <DispStr>[Bblu][Whi][Bold][Cle] <DispStr> -- AceComm Mini Host Script for AceComm v1.86 -- <Var0> <if>1 <DispStr>[AttrOff] <DispStr>^M^J^M^J <Var0> <if>1 <DispText>AnsiMainMenu <Var0> <if>0 <DispText>MainMenu :@@MainMenuKey <GetKey>60 ; <GetKey> times out every n seconds <if>1 <goto>@@BBS ; so if the caller drops carrier, we <if>C <goto>@@Comment ; can fall through to the carrier check <if>Y <goto>@@YourMail ; below. Default timeout is 60 if param. <if>R <goto>@@ReadMail <if>F <goto>@@Files <if>G <goto>@@OFF <if>^M <goto>@@MainMenu ; ^M for <CR> ; Note: any invalid key press while off line, ; results in '<goto>'@@Start <GetDCD> <if>0 <goto>@@NoDCD ; Detect if caller hung up <goto>@@MainMenuKey ; Wait for a key press we can process :@@BBS <ChgDir>BBS <RunProg>BBS %P %C <ChgDir>[DIR_START] <goto>@@MainMenu :@@Comment <HostEcho>ON ; This needs be on for message, even local <GetMsg> <Goto>@@MainMenu :@@YourMail <HostEcho>ON ; This needs be on for message, even local <YourMsg> <Goto>@@MainMenu :@@ReadMail <HostEcho>ON ; This needs be on for message, even local <ReadMsg> <Goto>@@MainMenu ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; Page 51 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ ; Files Menu ; :@@Files <DispStr>^M^L^M <Var0> <if>1 <DispStr>[BWhi][Blu] <DispStr>^M^J ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø <DispStr>^M^J ≥ (Z)modem AceComm version 1.86 ≥ <DispStr>^M^J ≥ (D)ownload file ≥ <DispStr>^M^J ≥ (U)load file ≥ <DispStr>^M^J ≥ (L)ist file titles ≥ <DispStr>^M^J ≥ (R)aw directory list ≥ <DispStr>^M^J ≥ (M)ain menu ≥ <DispStr>^M^J ≥ (G)ood bye ≥ <DispStr>^M^J ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ <Var0> <if>1 <DispStr>[AttrOff] <DispStr>^M^J^M^JSelect: :@@FilesKey <GetKey>60 <if>Z <goto>@@DownloadAceComm <if>D <goto>@@DownloadFile <if>U <goto>@@UploadFile <if>L <goto>@@ListFiles <if>R <goto>@@RawDir <if>M <goto>@@MainMenu <if>G <goto>@@OFF <if>^M <goto>@@Files <GetDCD> <if>0 <goto>@@NoDCD ; Detect if caller hung up <goto>@@FilesKey :@@DownloadAceComm <SendZmo@>@ACECOMM.LST <goto>@@Files ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Provide Download Options ; :@@DownloadFile <ChgDir>[DIR_DNLDS] ; So files displayed with ; <DirList>[DIR_DNLDS]\*.* can be found <DispStr> ^M^JEnter filename: <GetStr>15 <DispStr>^M :@@ChooseDnProtocol <DispStr>^M^JZ)modem <DispStr>^M^JY)modem / Ymodem G <DispStr>^M^JX)modem <GetKey>60 <if>Z <goto>@@ZmodemSend <if>Y <goto>@@YmodemSend <if>X <goto>@@XmodemSend <if>^M <goto>@@RetFiles <GetDCD> <if>0 <goto>@@NoDCD ; Detect if caller hung up <goto>@@ChooseDnProtocol :@@ZmodemSend <SendZmo>%FN <ChgDir>[DIR_START] <goto>@@Files Page 52 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ :@@YmodemSend <SendYmo1K>%FN :@@RetFiles <ChgDir>[DIR_START] <goto>@@Files :@@XmodemSend <SendXmo>%FN <ChgDir>[DIR_START] <goto>@@Files ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Provide Upload Options ; :@@UploadFile :@@ChooseUpProtocol <DispStr>^M^JZ)modem <DispStr>^M^JG)Ymodem G <DispStr>^M^JY)modem <DispStr>^M^JX)modem <GetKey>60 <if>Z <goto>@@ZmodemRecv <if>G <goto>@@YmodemGRecv <if>Y <goto>@@YmodemRecv <if>X <goto>@@XmodemRecv <if>^M <goto>@@Files ; <CR> alone aborts <GetDCD> <if>0 <goto>@@NoDCD ; Detect if caller hung up <goto>@@ChooseUpProtocol :@@ZmodemRecv <DispStr>^M^JBegin Zmodem Upload^M <RecvZmo> <goto>@@Files :@@YmodemGRecv <DispStr>^M^JBegin Ymodem G Upload^M <RecvYmoG> ; Note: the sending Ymodem sends <goto>@@Files ; filename in the first data block :@@YmodemRecv <DispStr>^M^JBegin Ymodem Upload^M <RecvYmo1k> <goto>@@Files :@@XmodemRecv <DispStr> ^M^JEnter filename: <GetStr>15 <DispStr>^M <RecvXmo>%FN <goto>@@Files ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Display ready made files list to caller ; :@@ListFiles <SendAscii>files.lst <DispStr>^M^JPress CR <GetKey>60 <goto>@@Files ;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; Display directory to caller ; :@@RawDir <DispStr>^M^J <DirList>[DIR_DNLDS]\*.* Page 53 AceComm (tm) v 1.90 ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ <DispStr>^M^JPress CR <GetKey>60 <goto>@@Files ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; ; ; Here when caller selects G)o option ; :@@NoDCD <DispStr>^M^JCarrier not detected, Restarting script! <DispStr>^M^JLocal mode, you can navigate the script by making correct <DispStr>^M^Jkey press for the menu options. :@@OFF <DispStr>^M^L^MGood bye [USR_NAM]! <DispStr>^M^JYour on line time [DCDTIME]^M^J <MdmHangUp> AutoAnswer>OFF ; Need this to recycle properly <Delay>2 ; This will help wait for modem response ; strings to clear <goto>@@Start ; ; Here when local keyboard E)nd option is selected ; :@@END <AutoAnswer>OFF <ClrWin> <EndS> ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;; {-DATA_AREA-} {-TEXT_START-}TellAutoAnswer [37;44m -- AceComm Mini Host Script for AceComm v1.86 -- [0m AceComm was first release on May 15 of 1993. Since then the script/macro language has evolved slowly. This is a very simple script allowing pre registered log in. The macro language will continue to evolve making possible a more elaborate host script. For a powerful Host mode, take a look at the AutoAnswer setup area. People are using AceComm as a front-end, and calling their favorite BBS software from the AutoAnswer macros. Sample setups for external BBS software are included in the manual. [34;47m⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø [0m [34;47m≥ L)ocal log in ≥ [0m [34;47m≥ C)ommand Shell ≥ [0m [34;47m≥ R)un LIST.COM ≥ [0m [34;47m≥ E)nd script ≥ [0m [34;47m¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ [0m {-TEXT_END-} {-TEXT_START-}AnsiMainMenu [34;47m⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø [0m [34;47m≥ 1) Through to BBS ≥ [0m [34;47m≥ 2) Download (*.REP) ≥ [0m [34;47m≥ 3) Uplopad (*.QWK) ≥ [0m [34;47m≥ C)omment to SysOp ≥ [0m Page 54 Chapter 4 Scripts ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ Mini Host Script Example (continued) ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒ [34;47m≥ Y)our mail ≥ [0m [34;47m≥ R)ead all messages ≥ [0m [34;47m≥ F)iles ≥ [0m [34;47m≥ G)o (hang up) ≥ [0m [34;47m¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ [0m Enter Choice: {-TEXT_END-} {-TEXT_START-}MainMenu ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø ≥ 1) Through to BBS ≥ ≥ 2) Download (*.REP) ≥ ≥ 3) Uplopad (*.QWK) ≥ ≥ C)omment to SysOp ≥ ≥ Y)our mail ≥ ≥ R)ead all messages ≥ ≥ F)iles ≥ ≥ G)o (hang up) ≥ ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ Enter Choice: {-TEXT_END-} Page 55 AceComm (tm) v 1.90 Chapter 5 LICENSE AceComm is not a Public Domain program and is not free. AceComm is copyright (C) 1990-1993 by MGP Programming Services. Non-registered users of this program are granted a limited 30 day license to evaluate the programs suitability for their requirements. Any usage of AceComm beyond the evaluation time period requires registration of each copy of the program used. Use of non- registered copies of AceComm beyond the original evaluation period is prohibited. AceComm may NOT be modified in any respect, for any reason, including but not limited to, de-compiling, disassembling, or reverse engineering of the program. The opening title screen, help screens, and all other proprietary program output must never be altered, removed, bypassed or modified by any means. You are free to distribute the PUBLICLY AVAILABLE evaluation version of AceComm to others subject to the above restrictions and also the following: A. No fee is charged for its use. B. No re numeration may be accepted for AceComm. This does not apply to computer access charges the system operators (Sysops) of or organizations owning bulletin board systems, on line services, etc... may charge subscribers. C. AceComm must be copied in unaltered form, complete with files containing license information, the FULL documentation and all accompanying files. The self-extracting archive distributed by MGP Programming Services must not be altered in ANY respect. D. All shareware houses/distribution firms must make explicitly clear that the diskette purchase containing any shareware program has NOT registered the software with the author MGP Programming Services Software/Michael G Phelps. Page 56 Chapter 5 LICENSE System Operators may make AceComm available for download only if the above conditions are met. The archive (Acennnn.EXE) distributed by AceComm or an equivalent archive may be made available only in complete form. Refer to FILELIST.DOC to verify complete package contents. If the contents appear altered or not complete, you may obtain the latest release of AceComm directly from MGP Programming Services by sending a formatted diskette labeled with the word "AceComm". Please include $5 for handling. The latest version of AceComm is also available on Compuserve. Commercial distributors of "Public Domain", "Shareware", and/or User Supported software may distribute AceComm subject to the above conditions only after obtaining WRITTEN permission from MGP Programming Services. This condition statement supersedes all previous agreements. Please refer to the section entitled registration/ordering section for additional information on registration, corporate site-licensing and related topics. Page 57 AceComm (tm) v 1.90 The above license statement does not apply to the REGISTERED version of AceComm. The registered software of MGP Programming Services is protected under United States Copyright and Trademark Laws. It must be treated just like a book with certain exceptions as follows: A. MGP Programming Services authorizes the making of archival copies of the registered software for the sole purpose of backing-up your software and protecting your investment from possible loss. B. The medium on which the registered software is recorded is transferred to the customer, but not the title to the software. C. The customer may resell or distribute unmodified copies of the registered software provided the customer has purchased from MGP Programming Services one copy of the registered software for each one sold or distributed. The provisions of this software license shall also be applicable to third parties receiving copies of the registered software from the customer. D. By saying, "just like a book", MGP Programming Services means that the registered software may be used by any number of people and may be freely moved from one computer location to another so long as there is ABSOLUTELY NO POSSIBILITY of it being used at one location while being used at another. Just like a book that cannot be read by two different people in two different locations at the same time. Page 58 Chapter 5 LICENSE Chapter 6 Contacting the author You can get more help by contacting the author Michael Phelps at the following AceComm Software Support ------------------------ - VOICE 602-846-4563 6 days 12-7pm MST - BBS 602-846-2940 24 hours - COMPUSERVE User ID 75120,3306 - FIDONET ADDRESS 1:114/35 - FIDONET COMM echo - FIDONET ACECOMM echo I distribute the "ACECOMM" echo to USA NODES, until it makes BACKBONE. - Write to: MGP Software (AceComm) * New address takes affect with BOX 301 C Route 3 AceComm 1.85 release. Phone Detroit Lakes, MN 56501 USA lines will remain the same until we actualy move later this year.